Skip to main content
Version: 24.03

Aspect Models

Industry Core kit banner

Aspect models are mostly easy to create by transforming a company's internal data into the target aspect model. Transformations are mostly straightforward in these cases. If necessary, special steps in creating aspect models are mentioned in the corresponding sections.

In the following section, all aspect models that are part of Industry Core are documented.

Digital Twin TypeAspect ModelMandatory Supported VersionOptionally Supported VersionsKIT
PartTypePartAsPlanned1.0.12.0.0Industry Core
SingleLevelBomAsPlanned1.1.02.0.0Industry Core
PartSiteInformationAsPlanned1.0.0Industry Core
SingleLevelUsageAsPlanned1.1.0Traceability
PartInstanceSerialPart1.0.12.0.0Industry Core
Batch2.0.02.0.1Industry Core
JustInSequencePart1.0.02.0.0Industry Core
SingleLevelBomAsBuilt1.0.02.0.0Industry Core
PartSiteInformationAsBuilt (shared aspect)1.0.0Industry Core
SingleLevelUsageAsBuilt2.0.0Traceability
TractionBatteryCode1.0.0Traceability

PartAsPlanned

PartAsPlanned represents an item in the Catena-X Bill of Material (BOM) in As-Planned lifecycle status in a specific version.

Aspect model in GitHub:

Example: Aspect Model PartAsPlanned 2.0.0 for a part type

{
"partTypeInformation": {
"classification": "component",
"manufacturerPartId": "123-0.740-3434-A",
"nameAtManufacturer": "Mirror left"
},
"partSitesInformationAsPlanned": [
{
"functionValidUntil": "2023-12-05T20:53:18.826+01:00",
"catenaXsiteId": "BPNS1234567890ZZ",
"function": "production",
"functionValidFrom": "2023-12-05T20:53:18.826+01:00"
}
],
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379"
}

Example: Aspect Model PartAsPlanned 1.0.1 for a part type

{
"partTypeInformation": {
"classification": "component",
"manufacturerPartId": "123-0.740-3434-A",
"nameAtManufacturer": "Mirror left"
},
"validityPeriod": {
"validFrom": "2021-06-14T06:55:29.935Z",
"validTo": "2022-06-14T06:55:29.935Z"
},
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379"
}

SingleLevelBomAsPlanned

The single-level Bill of Material represents one sub-level of an assembly and does not include any lower-level subassemblies. In as planned lifecycle state all variants are covered (\"120% BoM\"). If multiple versions of child parts exist that can be assembled into the same parent part, all versions of the child part are included in the BoM. If there are multiple suppliers for the same child part, each supplier has an entry for their child part in the BoM.

Aspect model in GitHub:

Example: Aspect Model SingleLevelBomAsPlanned 2.0.0 for a Catalog Part

{
"catenaXId": "urn:uuid:055c1128-0375-47c8-98de-7cf802c3241d",
"childItems": [
{
"catenaXId": "urn:uuid:5daB938E-Cafa-92B3-7ca1-9aD7885e9dC8",
"validityPeriod" : {
"validFrom" : "2023-03-21T08:17:29.187+01:00",
"validTo" : "2024-07-01T16:10:00.000+01:00"
},
"quantity": {
"quantityNumber": 2.5,
"measurementUnit": "unit:litre"
},
"createdOn": "2022-02-03T14:48:54.709Z",
"businessPartner": "BPNL50096894aNXY",
"lastModifiedOn": "2022-02-03T14:48:54.709Z"
}
]
}

Example: Aspect Model SingleLevelBomAsPlanned 1.1.0 for a Catalog Part

{
"catenaXId" : "urn:uuid:055c1128-0375-47c8-98de-7cf802c3241d",
"childParts" : [ {
"childCatenaXId" : "fEbdF497-B223-8365-dEbe-df4A6E67bDee",
"validityPeriod" : {
"validFrom" : "2023-03-21T08:17:29.187+01:00",
"validTo" : "2024-07-01T16:10:00.000+01:00"
},
"quantity" : {
"quantityNumber" : 2.5,
"measurementUnit" : "unit:litre"
},
"createdOn" : "2022-02-03T14:48:54.709Z",
"lastModifiedOn" : "2022-02-03T14:48:54.709Z"
} ]
}

PartSiteInformationAsPlanned

The aspect provides site related information for a given as planned item (i.e. a part type or part instance that is uniquely identifiable within Catena-X via its Catena-X ID). A site is a delimited geographical area where a legal entity does business. In the "as planned" lifecycle context all potentially related sites are listed including all sites where e.g. production of this part (type) is planned.

Aspect model in GitHub:

Example: Aspect Model PartSiteInformationAsPlanned 1.0.0 for a Component that is Produced at the Given Site

{
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"sites": [
{
"catenaXSiteId": "BPNS1234567890ZZ",
"functionValidUntil": "2025-11-21T11:14:30.825+01:00",
"function": "production",
"functionValidFrom": "2022-11-21T11:14:30.825+01:00"
}
]
}

PartSiteInformationAsBuilt (shared aspect)

The aspect provides site related information for a given item(i.e. a part type or part instance that is uniquely identifiable within Catena-X via its Catena-X ID). A site is a delimited geographical area where a legal entity does business. In this context all potentially related sites are listed including all sites where e.g. production of this part(type).

Aspect model in GitHub:

Example: Aspect Model PartSiteInformationAsBuilt 1.0.0 for a component that is produced at the given site

{
"catenaXId" : "580d3adf-1981-44a0-a214-13d6ceed9379",
"sites" : [ {
"catenaXsiteId" : "BPNS1234567890ZZ",
"function" : "production"
} ]
}

SerialPart

A serialized part is an instantiation of a (design-) part, where the particular instantiation can be uniquely identified by means of a serial numbers or a similar identifier (e.g. VAN) or a combination of multiple identifiers (e.g. combination of manufacturer, date and number)

Aspect model in GitHub:

Example: Aspect Model SerialPart 2.0.0 for a Vehicle

{
"localIdentifiers": [
{
"key": "manufacturerId",
"value": "BPNL7588787849VQ"
},
{
"key": "manufacturerPartId",
"value": "95657362-83"
},
{
"key": "partInstanceId",
"value": "OEM-A-F8LM95T92WJ9KNDD3HA5P"
},
{
"key": "van",
"value": "OEM-A-F8LM95T92WJ9KNDD3HA5P"
}
],
"manufacturingInformation": {
"date": "2022-02-04T14:48:54",
"country": "DEU"
},
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"sites": [
{
"catenaXsiteId": "BPNS1234567890ZZ",
"function": "production"
}
],
"partTypeInformation": {
"manufacturerPartID": "QX-39",
"classification": "product",
"nameAtManufacturer": "Vehicle Model A"
}
}

Example: Aspect Model SerialPart 2.0.0 for a Serialized Part (Non-Vehicle)

{
"localIdentifiers": [
{
"key": "manufacturerId",
"value": "BPNL7588787849VQ"
},
{
"key": "manufacturerPartId",
"value": "95657362-83"
},
{
"key": "partInstanceId",
"value": "NO-574868639429552535768526"
}
],
"manufacturingInformation": {
"date": "2022-02-04T14:48:54",
"country": "DEU"
},
"catenaXId": "urn:uuid:d60b99b0-f269-42f5-94d0-64fe0946ed04",
"sites": [
{
"catenaXsiteId": "BPNS1234567890ZZ",
"function": "production"
}
],
"partTypeInformation": {
"manufacturerPartID": "95657362-83",
"customerPartId": "798-515297795-A",
"classification": "component",
"nameAtManufacturer": "High Voltage Battery",
"nameAtCustomer": "High Voltage Battery"
}
}

Example: Aspect Model SerialPart 1.0.1 for a Vehicle

{
"localIdentifiers": [
{
"key": "manufacturerId",
"value": "BPNL7588787849VQ"
},
{
"key": "manufacturerPartId",
"value": "95657362-83"
},
{
"key": "partInstanceId",
"value": "OEM-A-F8LM95T92WJ9KNDD3HA5P"
},
{
"key": "van",
"value": "OEM-A-F8LM95T92WJ9KNDD3HA5P"
}
],
"manufacturingInformation": {
"date": "2022-02-04T14:48:54",
"country": "DEU"
},
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"partTypeInformation": {
"manufacturerPartID": "QX-39",
"classification": "product",
"nameAtManufacturer": "Vehicle Model A"
}
}

Example: Aspect Model SerialPart 1.0.1 for a Serialized Part (Non-Vehicle)

{
"localIdentifiers": [
{
"key": "manufacturerId",
"value": "BPNL7588787849VQ"
},
{
"key": "manufacturerPartId",
"value": "95657362-83"
},
{
"key": "partInstanceId",
"value": "NO-574868639429552535768526"
}
],
"manufacturingInformation": {
"date": "2022-02-04T14:48:54",
"country": "DEU"
},
"catenaXId": "urn:uuid:d60b99b0-f269-42f5-94d0-64fe0946ed04",
"partTypeInformation": {
"manufacturerPartID": "95657362-83",
"customerPartId": "798-515297795-A",
"classification": "component",
"nameAtManufacturer": "High Voltage Battery",
"nameAtCustomer": "High Voltage Battery"
}
}

Creation of Aspect Model SerialPart

The only special step in creating this aspect model is the initial creation of the Unique ID for the corresponding part.

Batch

A batch is a quantity of (semi-) finished products or (raw) material product that have been produced under the same circumstances (e.g. same production location), as specified groups or amounts, within a certain time frame. Every batch can differ in the number or amount of products. Different batches can have varied specifications, e.g., different colors. A batch is identified via a Batch ID.

Aspect model in GitHub:

Example: Aspect Model Batch 2.0.1 for a Batch of Raw Material

{
"localIdentifiers": [
{
"value": "BID12345678",
"key": "batchId"
}
],
"manufacturingInformation": {
"date": "2022-02-04T14:48:54",
"country": "HUR"
},
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"sites": [
{
"catenaXsiteId": "BPNS1234567890ZZ",
"function": "production"
}
],
"partTypeInformation": {
"manufacturerPartId": "123-0.740-3434-A",
"classification": "product",
"nameAtManufacturer": "PA66-GF30",
}
}

Example: Aspect Model Batch 2.0.0 for a Batch of Raw Material

{
"localIdentifiers": [
{
"value": "BID12345678",
"key": "batchId"
}
],
"manufacturingInformation": {
"date": "2022-02-04T14:48:54",
"country": "HUR"
},
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"partTypeInformation": {
"manufacturerPartId": "123-0.740-3434-A",
"classification": "product",
"nameAtManufacturer": "PA66-GF30",
}
}

Creation of Aspect Model Batch

The only special step in creating this aspect model is the initial creation of the Unique ID for the corresponding batch.

JustInSequencePart

A just-in-sequence part is an instantiation of a (design-) part, where the particular instantiation can be uniquely identified by means of a combination of several IDs related to a just-in-sequence process.

Aspect model in GitHub:

Example: Aspect Model JustInSequencePart 2.0.0 for a non-serialized component

{
"localIdentifiers": [
{
"key": "manufacturerId",
"value": "BPNL7588787849VQ"
},
{
"key": "jisNumber",
"value": "894651684"
},
{
"key": "parentOrderNumber",
"value": "OEM-A-F8LM95T92WJ9KNDD3HA5P"
},
{
"key": "jisCallDate",
"value": "2022-01-24T09:13:34"
}
],
"manufacturingInformation": {
"date": "2022-02-04T14:48:54",
"country": "DEU"
},
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"sites": [
{
"catenaXsiteId": "BPNS1234567890ZZ",
"function": "production"
}
],
"partTypeInformation": {
"manufacturerPartID": "84816168424",
"classification": "product",
"nameAtManufacturer": "Black Leather Front Row Seat for Vehicle Model B"
}
}

Example: Aspect Model JustInSequencePart 1.0.0 for a non-serialized component

{
"localIdentifiers": [
{
"key": "manufacturerId",
"value": "BPNL7588787849VQ"
},
{
"key": "jisNumber",
"value": "894651684"
},
{
"key": "parentOrderNumber",
"value": "OEM-A-F8LM95T92WJ9KNDD3HA5P"
},
{
"key": "jisCallDate",
"value": "2022-01-24T09:13:34"
}
],
"manufacturingInformation": {
"date": "2022-02-04T14:48:54",
"country": "DEU"
},
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"partTypeInformation": {
"manufacturerPartID": "84816168424",
"classification": "product",
"nameAtManufacturer": "Black Leather Front Row Seat for Vehicle Model B"
}
}

Please note that if a just-in-sequence part is also a serialized part, SerialPart should be used instead.

Creation of Aspect Model JustInSequencePart

The only special step in creating this aspect model is the initial creation of the Unique ID for the corresponding part.

SingleLevelBomAsBuilt

The aspect provides the child parts (one structural level down) which the given object assembles.

Aspect model in GitHub:

Example: Aspect Model SingleLevelBomAsBuilt 2.0.0 for a Serialized Part

{
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"childItems": [
{
"quantity": {
"quantityNumber": 1.0,
"measurementUnit": "unit:piece"
},
"hasAlternatives": false,
"createdOn": "2022-02-03T14:48:54.709Z",
"lastModifiedOn": "2022-02-03T14:48:54.709Z",
"catenaXId": "urn:uuid:d60b99b0-f269-42f5-94d0-64fe0946ed04",
"businessPartner": "BPNL50096894aNXY"
}
]
}

Aspect Model SingleLevelBomAsBuilt 2.0.0 for a Batch

{
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"childItems": [
{
"quantity": {
"quantityNumber": 25.0,
"measurementUnit": "unit:kilogram"
},
"hasAlternatives": false,
"createdOn": "2022-02-03T14:48:54.709Z",
"lastModifiedOn": "2022-02-03T14:48:54.709Z",
"catenaXId": "urn:uuid:d60b99b0-f269-42f5-94d0-64fe0946ed04",
"businessPartner": "BPNL50096894aNXY"
}
]
}

Example: Aspect Model SingleLevelBomAsBuilt 1.0.0 for a Serialized Part

{
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"childItems": [
{
"quantity": {
"quantityNumber": 1.0,
"measurementUnit": "unit:piece"
},
"createdOn": "2022-02-03T14:48:54.709Z",
"lastModifiedOn": "2022-02-03T14:48:54.709Z",
"catenaXId": "urn:uuid:d60b99b0-f269-42f5-94d0-64fe0946ed04",
"businessPartner": "BPNL50096894aNXY"
}
]
}

Aspect Model SingleLevelBomAsBuilt 1.0.0 for a Batch

{
"catenaXId": "urn:uuid:580d3adf-1981-44a0-a214-13d6ceed9379",
"childItems": [
{
"quantity": {
"quantityNumber": 25.0,
"measurementUnit": "unit:kilogram"
},
"createdOn": "2022-02-03T14:48:54.709Z",
"lastModifiedOn": "2022-02-03T14:48:54.709Z",
"catenaXId": "urn:uuid:d60b99b0-f269-42f5-94d0-64fe0946ed04",
"businessPartner": "BPNL50096894aNXY"
}
]
}

Creation of Aspect Model SingleLevelBomAsBuilt

The creation of the aspect model SingleLevelBomAsBuilt is more complicated. This aspect model contains the Unique ID of the manufacturer's part (attribute catenaXId) which is created - as described above - when the part's SerialPart or Batch aspect model is created. But it also contains the Unique IDs of the built-in parts (attributes childItems.catenaXId), as shown in the example above.

For the build-in parts (child items), their Unique ID is not known to the manufacturer initially. Only know are the local ids that are printed on the physical part (serialized part or batch), i.e., manufacturer (BPN), manufacturer part id and serial or batch number. To get the Unique ID of a built-in part, a data provider therefore has to do the following:

  • Get all necessary local ids for the built-in part:
    • manufacturer (BPN), manufacturer part id and serial number for serialized parts
    • manufacturer (BPN), manufacturer part id and batch number for batches
  • The next step is about getting the Unique ID of all built-in parts. There are two ways:
    • Unique IDs might for built-in parts might already be available locally if Unique ID Push is supported by the data provider and the suppliers of the built-in parts.
    • Query a supplier's Digital Twin Registry to find the digital twin for this built-in part

NOTICE

This work is licensed under the CC-BY-4.0.

  • SPDX-License-Identifier: CC-BY-4.0
  • SPDX-FileCopyrightText: 2023 BASF SE
  • SPDX-FileCopyrightText: 2023 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
  • SPDX-FileCopyrightText: 2023 Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V. (represented by Fraunhofer ISST & Fraunhofer IML)
  • SPDX-FileCopyrightText: 2023 German Edge Cloud GmbH & Co. KG
  • SPDX-FileCopyrightText: 2023 Mercedes Benz AG
  • SPDX-FileCopyrightText: 2023 Robert Bosch Manufacturing Solutions GmbH
  • SPDX-FileCopyrightText: 2023 SAP SE
  • SPDX-FileCopyrightText: 2023 Siemens AG
  • SPDX-FileCopyrightText: 2023 T-Systems International GmbH
  • SPDX-FileCopyrightText: 2023 ZF Friedrichshafen AG
  • SPDX-FileCopyrightText: 2023 Contributors to the Eclipse Foundation
  • Source URL: https://github.com/eclipse-tractusx/eclipse-tractusx.github.io/tree/main/docs-kits/kits/Industry%20Core%20Kit (latest version)